home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / YPSERV-1.{2U / INSTALL.{_1 < prev    next >
Text File  |  1999-09-17  |  6KB  |  143 lines
  1.  
  2. HOW TO BUILD AND INSTALL:
  3.  
  4.   1. Generate a Makefile:
  5.      For a standard installation, run "BUILD" and go to 4.
  6.      Or you could run configure
  7.      configure accepts a lot of options. Try configure --help.
  8.      Normally, you only need the following:
  9.  
  10.      --with-gdbm-dir=BASE-DIR :
  11.        If your system do not have the GDBM library in /lib, /usr/lib
  12.        or /usr/local/lib, and the header files in a usually place,
  13.        you could tell the linker where to find the library and header files.
  14.        On our Sun's, the libgdbm.a is installed under
  15.        /usr/local/gnu/gdbm/[lib|include], so the option is:
  16.        --with-gdbm-dir=/usr/local/gnu/gdbm
  17.  
  18.      --with-ndbm=[yes|no] :
  19.        If you doesn't have the GDBM library installed, or wishes to
  20.        use libdb in ndbm compat mode, use this option. It was primarly
  21.        for Solaris, which has ndbm support.
  22.  
  23.        PLEASE read the README file for more information and problems
  24.        with this !!
  25.  
  26.      --enable-tcp-wrapper[=BASE-DIR] :
  27.        By default, ypserv will look in the /var/yp/securenets file, if
  28.        a host is allow to connect to the server. The tcp wrapper lib
  29.        is much more flexible. With this option, you could enable it.
  30.        The securenets file will not be used in this case. As optional
  31.        argument you could give the path to the header file and library.
  32.  
  33.        For more information, look at the README.secure file.
  34.  
  35.        THIS OPTION WILL NOT BE SUPPORTED ANY LONGER FROM ME !!
  36.  
  37.      --enable-yppasswd :
  38.        Compile and install the yppasswd client. By default, this program
  39.        will be not installed.
  40.  
  41.      --enable-ypmake :
  42.        ypmake is a perl script, which creates the maps faster for smaller
  43.        sites. By default, it will not be installed.
  44.  
  45.      --enable-checkroot :
  46.        Allow root to change NIS passwords with yppasswd for normal users.
  47.        At first, the old password will be checked against the old user
  48.        password, then against the root password. This is by default
  49.        enabled.
  50.  
  51.      --enable-fqdn :
  52.        With this option, all hostnames will be checked against DNS.
  53.        You need this, if your servers are in different DNS domains,
  54.        but in the same NIS domain. The communication between the
  55.        NIS server will be a little bit slower. The communication
  56.        with the clients is not affected from this.
  57.  
  58.  
  59.   2. Edit the "Makefile" to suit your needs.
  60.  
  61.   3. Type "make".
  62.  
  63.   4. Type "make install" as root from the build directory.
  64.  
  65.   5. Go in the etc subdirectory and edit the "ypserv.conf" and
  66.      "securenets" file for your system and copy them to the correct
  67.      places. If you use the tcp wrapper, you don't need "securenets".
  68.  
  69.   6. If you use the tcp wrapper library, you must modify your
  70.      /etc/hosts.allow and /etc/hosts.deny files. Else you should
  71.      create the /var/yp/securenets file. If not, everybod on the
  72.      world could connect to your server, if he knows the NIS domainname.
  73.  
  74.      DON'T USE THE setenv OPTION IN THIS CONFIGURATION FILES !
  75.  
  76.   7. Make sure your domainname is set ! /bin/domainname shouldn't
  77.      return an empty string or "(none)". If, you have real problems
  78.      or forget to set the domainname. After setting the domainname,
  79.      make sure it will be set on the next boot again, and reboot !
  80.  
  81.   8. Possible modify /var/yp/Makefile to suit your setup. Remove/add
  82.      all maps to the all: line, which should be build and distributed
  83.      by your NIS server.
  84.  
  85.   9. If you will use "ypmake", copy /var/yp/ypmake.conf.sample
  86.      to /var/yp/<yp-domainname>/ypmake.conf and modify it for
  87.      your system.
  88.  
  89.  10. If you only have one ypserv server in your domain, do:
  90.      cd /var/yp; make or call ypmake
  91.      This will create the maps.
  92.  
  93.  11. If you have more then one ypserv server in your domain (you should
  94.      have one for every subnet), run "/usr/lib/yp/ypinit -m" on the
  95.      master host. ypinit will ask some Questions and create all
  96.      neccessary maps. You must comment out the NOPUSH = "True" line
  97.      in /var/yp/Makefile, or the master will never send updates to the
  98.      slave server.
  99.      On the slave server hosts, you only have to run
  100.      "/usr/lib/yp/ypinit -s masterhost", this will get all the maps from
  101.      the master ypserv.
  102.      WARNING: If you use a libc with NYS support or ypinit has trouble
  103.               to find the maps, install ypwhich from the ypwhich-nys
  104.               directory. This ypwhich will not work with GNU libc !
  105.  
  106.  12. If you have slave NIS server, you should start rpc.ypxfrd on the
  107.      master host. You don't need rpc.ypxfrd on any slave server. You
  108.      could start rpc.ypxfrd from a /etc/rc* script or by inetd. For
  109.      the last, you have to add:
  110.      * to /etc/rpc:
  111.        fypxfrd         600100069 freebsd-ypxfrd
  112.      * to /etc/inetd.conf:
  113.        fypxfrd/1 dgram  rpc/udp wait   root /usr/sbin/rpc.ypxfrd rpc.ypxfrd
  114.        fypxfrd/1 stream rpc/tcp nowait root /usr/sbin/rpc.ypxfrd rpc.ypxfrd
  115.      Since this ypxfrd implementation uses the FreeBSD ypxfrd protocoll,
  116.      you could not contact a Sun ypxfrd and you could not use the ypxfrd
  117.      entrys from a Sun.
  118.      ypxfrd needs a lot of time by starting from inetd, you should start it
  119.      by a /etc/rc* script.
  120.  
  121.  13. On bootup, start ypserv from a /etc/rc* script. If this server is a
  122.      master or the only one, you have to start rpc.yppasswdd, too.
  123.  
  124.  14. If your users are allowed to change the shell, add -e chsh to
  125.      rpc.yppasswdd as parameter. For changing the GECOS field, add -e chfn.
  126.  
  127.  
  128. IMPORTANT NOTES:
  129. ================
  130.  
  131. Please note that the /var/yp/Makefile needs GNU Awk (or a compatible
  132. version like mawk, which should be faster) to work.
  133.  
  134. If you will use the --dns flag, you need gethostbyname and gethostbyaddr
  135. functions, which querys directly the nameserver, and do not call the
  136. server `ypserv', which calls the functions, and you have a loop.
  137. Under Linux, ypserv uses the functions in dns_hosts.c by default, you
  138. have nothing to do. Under SunOS/Solaris, you could install and use the
  139. resolv+ library, which worked great for me.
  140.  
  141.  
  142. Thorsten Kukuk <kukuk@uni-paderborn.de>
  143.